home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / c / sozobon / sozuti09.zoo / sozdistr / doc / binary.doc / nm.man < prev    next >
Encoding:
Text File  |  1995-04-09  |  3.1 KB  |  133 lines
  1.  
  2.  
  3. NM(1)                 Sozobon Programmer's Manual                  NM(1)
  4.  
  5.  
  6.  
  7.  
  8. NAME
  9.  
  10.         nm  - SozobonX nm display a symbol table for an object module or
  11.                 archive
  12.  
  13. SYNOPSIS
  14.         nm [-<options>] <file> [<file> ...]
  15.  
  16.         nm [-Vvhg8o] <file> [<file> ...]
  17.  
  18. DESCRIPTION
  19.         nm nm is a standard utility on many platforms.  It  is  used  to
  20.         display  the  symbol  table  of  an  object module or the symbol
  21.         tables of the object modules in an archive.
  22.  
  23.         The printed table
  24.  
  25.         <offset in TEXT/DATA/BSS> <type of symbol> <name>
  26.         or
  27.         <length of common symbol's object>  <C> <name>
  28.  
  29.         Example: test.o:
  30.                00000000 T _testoutfunc
  31.                00000008 C _rest
  32.  
  33.         With the verbose option enabled, one column is  inserted  before
  34.         <type of  symbol>;  the  symbol type value in hex notation.  For
  35.         every SozobonX module, a '(SozobonX)' message is displayed after
  36.         the module name.
  37.  
  38.         Example: test.o:
  39.                (SozobonX)
  40.                00000000 a200 T _testoutfunc
  41.                00000008 a800 C _rest
  42.  
  43.         The symbol type keys:
  44.         The symbol types known to this utility are:
  45.  
  46.         '?' Unknown
  47.  
  48.         'a' This can be any absolute symbol.
  49.  
  50.         'b' This is a BSS symbol (uninitialized and local variables).
  51.  
  52.         'd' This is a DATA symbol (initilized variables).
  53.  
  54.         't' This is a TEXT symbol (a function).
  55.  
  56.         'C' This is a common symbol (uninitialized global variables).
  57.  
  58.         'U' This is an undefined used external symbol  (e.g an  external
  59.                 function).
  60.  
  61.  
  62.  
  63.  
  64. v 2.00x3                  Release: May 20 1994                    Page 1
  65.  
  66.  
  67.  
  68.  
  69. NM(1)                 Sozobon Programmer's Manual                  NM(1)
  70.  
  71.  
  72.  
  73.         Uppercase  letters refer to globally visible symbols, and lower-
  74.         case letters to local symbols.
  75.  
  76.         If a GST symbol or ALN special symbol is recognized,  this  will
  77.         be noted in an additional column.
  78.  
  79.         The  -8 option shows the symbols as they would look to a program
  80.         which knows nothing about SozobonX format.
  81.  
  82. OPTIONS
  83.  
  84.          --version 
  85.          -V 
  86.              Print detailed Version information to stdout and exit
  87.  
  88.          --help 
  89.          -h 
  90.              Display usage information and exit.
  91.  
  92.          v   (verbose) 
  93.              Force  nm to be verbose about what it is doing.
  94.  
  95.          -g 
  96.              Only list global symbols.
  97.  
  98.          -8 
  99.              Do not recognize SozobonX format symbols.
  100.  
  101.          --oldstyle 
  102.          -o 
  103.              Force output to be in the old Sozobon nm format.
  104.  
  105. SEE ALSO
  106.         ar(1), liborder(1), ld(1)
  107.  
  108. BUGS
  109.         Without doubt,  there  are  some  bugs  in this program.  If you
  110.         discover one, please report it to maintainer.
  111.  
  112. AUTHOR
  113.         nm V2.00 Copyright (c) 1988-1991 by Sozobon, Ltd.  For  eXtended
  114.         Version by Jerry Geiger (1992-1994)
  115.  
  116. VERSION
  117.         nm V2.00x3 May 20 1994
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. v 2.00x3                  Release: May 20 1994                    Page 2
  131.  
  132.  
  133.